/**
 * Copyright (c) 2011 eelpo.com
 * All rights reserved.
 */
package com.eelpo.cmmp.uac.dao;

import java.util.List;

import com.eelpo.cmmp.core.exception.ServiceException;
import com.eelpo.cmmp.uac.dao.entity.TUser;
import com.eelpo.cmmp.uac.dao.vo.User;

import org.springframework.dao.DataAccessException;

/**
 * <pre>
 * 用户管理数据访问接口定义
 * </pre>
 * 
 * @author <a href="mailto:Brian@eelpo.com">汪洪州</a>
 * @since 1.0
 */
public interface IUserManageDao {

	/**
	 * 根据用户Id获取用户对象
	 * 
	 * @param id
	 *            用户ID
	 * @return 返回用户值对象
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public TUser getUserById(String id) throws DataAccessException;

	/**
	 * 根据用户帐号获取用户对象
	 * 
	 * @param account
	 *            用户帐号
	 * @return 返回用户值对象
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public TUser getUserByAccount(String account) throws DataAccessException;

	/**
	 * 检查用户帐号是否已经存在
	 * 
	 * @param account
	 *            用户帐号
	 * @return 返回布尔值，true表示已经存在，false表示不存在
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public boolean checkExist(String account) throws DataAccessException;

	/**
	 * 检查用户帐号是否已经存在，用于修改用户
	 * 
	 * @param id
	 *            用户Id
	 * @param account
	 *            用户帐号
	 * @return 返回布尔值，true表示已经存在，false表示不存在
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public boolean checkExistByUpdate(String id, String account) throws DataAccessException;

	/**
	 * 新增用户
	 * 
	 * @param user
	 *            用户对象
	 * @return 返回新增过的用户Id
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public String addUser(TUser user) throws DataAccessException;

	/**
	 * 修改用户
	 * 
	 * @param user
	 *            用户对象
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public void updateUser(TUser user) throws DataAccessException;

	/**
	 * 根据Id删除用户
	 * 
	 * @param id
	 *            用户Id
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public void deleteUser(String id) throws DataAccessException;

	/**
	 * 根据参数获取用户分页列表
	 * 
	 * @param user
	 *            用户参数
	 * @param first
	 *            分页起始条数
	 * @param max
	 *            分页获取的单页条数
	 * @return 返回用户分页列表
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public List<TUser> getUsersPaing(User user, final int first, final int max) throws DataAccessException;

	/**
	 * 根据参数获取用户分页列表
	 * 
	 * @param userId
	 *            登录用户的ID
	 * @param user
	 *            用户参数
	 * @param first
	 *            分页起始条数
	 * @param max
	 *            分页获取的单页条数
	 * @return 返回用户分页列表
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public List<TUser> getUsersPaing(String userId, User user, final int first, final int max) throws DataAccessException;

	/**
	 * 根据参数获取用户数量
	 * 
	 * @param user
	 *            用户参数
	 * @return 返回用户数量
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public int getUsersCount(User user) throws DataAccessException;

	/**
	 * 根据参数获取用户数量
	 * 
	 * @param userId
	 *            登录用户的ID
	 * @param user
	 *            用户参数
	 * @return 返回用户数量
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public int getUsersCount(String id, User user) throws DataAccessException;

	/**
	 * 获取超级管理员
	 * 
	 * @return 返回超级管理员
	 * @throws DataAccessException
	 *             抛出数据访问异常
	 */
	public TUser getSuperManager() throws ServiceException;
}
